home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 191 / applic / topmap.doc < prev    next >
Text File  |  1987-11-20  |  5KB  |  111 lines
  1. *****************************************************
  2. *           Fractal Topographical Maps              *
  3. *       Copyright (c) 1987 by Robert Adam II        *
  4. *              All rights reserved.                 *
  5. *****************************************************
  6.  
  7.  PURPOSE:
  8.     This program can be used to create a contoured surface 
  9.     with features resembling natural geological formations
  10.     (lakes, mountains, ...).  You may also display the results
  11.     in a limited number of ways.  
  12.         The display looks best in low resolution.  High resolution
  13.     looks almost as good as low.  Medium resolution looks rather
  14.     poor.
  15.  
  16.        
  17.  LANGUAGE:
  18.     This program was written entirely in Personal Pascal from OSS.
  19.  
  20.         
  21.  USE:
  22.     This is a GEM based program.
  23.  
  24.     FILE    load - load in a saved map file
  25.         new  - create a new map using the height and width from
  26.                       from OPTIONS menu
  27.          old  - load a map saved by version 0.1
  28.         save - save the current map to a file and, in the process,
  29.               name it
  30.         
  31.     VIEW    isometric   - a modified isometric view
  32.                 overhead    - a view from directly above which is the
  33.                              one you normally get when you create a new
  34.                  map
  35.                 perspective - a perspective view
  36.  
  37.     OPTIONS remap  - causes the display of a map with its altitude 
  38.                         range expanded to encompass the maximum range
  39.                         (does not change the data; ignored during creation
  40.                         of new map)
  41.                 shadow - when drawing a map, produce shadows as though
  42.             the sun was to the left of the picture.  You will
  43.                         be given a choice of three angles (Low, Medium,
  44.                         High).  When shadow is off, all the colors used
  45.                         to produce shadows are used with the normal colors
  46.                         so that more levels may be displayed (Thanks to
  47.                         Dan Rhea for the suggestion.)
  48.         watch  - allows you to watch while a new map is being
  49.             produced.  ( You may want to hide the map from 
  50.                         yourself if you will be using it in a game that
  51.                         you will be playing. )
  52.         water  - if "water" is on you cannot see below the surface
  53.             otherwise you see the underwater land contours
  54.         height - how many "tiles" high a new map will be
  55.         width  - how many "tiles" wide a new map will be
  56.         reset  - reset the colors to the TOPMAP setup (in case a
  57.             desk accessory changes back to the default colors
  58.                         or you have loaded a map created by a version of
  59.                         TOPMAP previous to 0.3)
  60.  
  61.  MISCELLANEOUS:
  62.     You may cancel the display or creation of a map by pressing the 
  63.       left mouse button and holding it until the alert box appears then 
  64.       clicking on the YES option.  You may not resume a canceled display, 
  65.       though you may restart it.
  66.     
  67.     The SAVE and LOAD really do take a long time (~1 min. 30 sec. for
  68.       SAVE about half that for LOAD), it's not just your imagination.
  69.  
  70.     To map the colors to altitude in a shadowed display, I divided the 
  71.       altitude range into 9 evenly sized pieces.  I assigned three of these 
  72.       pieces to the water (blue) region, while each of the other colors got 
  73.       one piece.
  74.         To map the colors to altitude in an unshadowed display, I divided the
  75.       altitude range into 13 evenly sized pieces. I assigned one piece to each
  76.       color.
  77.  
  78.  DATA FILE FORMAT:
  79.       The file is a Pascal file of integer (where an integer is a 16 bit word).
  80.  
  81.     word offset    value stored
  82.        ----------------------------------------------------------    
  83.     0        number of tiles in width
  84.     1        number of tiles in height
  85.     2-17        colors from xbios(7) call stored 0 to 15
  86.     ...        the data for the map stored in row order
  87.  
  88.     A "tile" is a square that is 65 pixels on a side.  The adjacent
  89.       tiles overlap by a column (or row), so in a 3 by 2 (width by height)
  90.       tile map, the pixel size is 193 by 129 instead of the expected
  91.       195 by 130.
  92.         The map data should be in the range of 0 to 25000 but it sometimes
  93.       strays out of bounds.
  94.     The map is stored a row at a time so the first 193 words of data for
  95.       a 3 tile wide map will be the first horizontal line of the map.
  96.  
  97.  
  98.  BUG FIXES:
  99.    0.3    - no more horizontal streaks of shadows in perspective and isometric
  100.          displays.
  101.  
  102.  FINAL NOTES:
  103.     If you have any questions or comments you may reach me at one of
  104.       the following addresses:
  105.  
  106.         CompuServe: [74226,623]
  107.  
  108.                 U.S. Mail : Robert Adam II
  109.                             8029-B Trapier Ave.
  110.                 New Orleans, LA 70127
  111.